home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d927.lha / Telnet / telnet.man < prev    next >
Text File  |  1993-10-07  |  13KB  |  289 lines
  1.  
  2.  
  3.  
  4. TELNET(1C)                USER COMMANDS                TELNET(1C)
  5.  
  6.  
  7.  
  8. NAME
  9.      telnet - user interface to a remote system using the  TELNET
  10.      protocol
  11.  
  12. DESCRIPTION
  13.      telnet communicates with another host using the TELNET  pro-
  14.      tocol.   If  telnet  is invoked without arguments, it enters
  15.      command mode, indicated by its prompt  (telnet>).   In  this
  16.      mode, it accepts and executes the commands listed below.  If
  17.      it is invoked with arguments, it performs  an  open  command
  18.      (see below) with those arguments.
  19.  
  20.      Once a connection has been opened, telnet enters input mode.
  21.      In  this  mode,  text typed is sent to the remote host.  The
  22.      input mode entered will be either "character at a  time"  or
  23.      "line by line" depending on what the remote system supports.
  24.  
  25.      In "character at a time" mode, most text  typed  is  immedi-
  26.      ately sent to the remote host for processing.
  27.  
  28.      In "line by line" mode, all  text  is  echoed  locally,  and
  29.      (normally) only completed lines are sent to the remote host.
  30.      The "local echo character" (initially `^E') may be  used  to
  31.      turn off and on the local echo (this would mostly be used to
  32.      enter passwords without the password being echoed).
  33.  
  34.      In either mode,  if  the  localchars  toggle  is  TRUE  (the
  35.      default in line mode; see below), the user's quit, intr, and
  36.      flush characters are trapped locally,  and  sent  as  TELNET
  37.      protocol  sequences  to  the remote side.  There are options
  38.      (see toggle autoflush  and  toggle  autosynch  below)  which
  39.      cause this action to flush subsequent output to the terminal
  40.      (until the remote host acknowledges the TELNET sequence) and
  41.      flush  previous  terminal  input  (in  the  case of quit and
  42.      intr).
  43.  
  44.      While connected to a remote host, telnet command mode may be
  45.      entered  by  typing the telnet "escape character" (initially
  46.      `^]', (control-right-bracket)).  When in command  mode,  the
  47.      normal terminal editing conventions are available.
  48.  
  49. USAGE
  50.   Telnet Commands
  51.  
  52.      The following commands are available.  Only enough  of  each
  53.      command  to uniquely identify it need be typed (this is also
  54.      true for arguments to the mode,  set,  toggle,  and  display
  55.      commands).
  56.  
  57.      open host [ port ]
  58.           Open a connection to the named host.  If no port number
  59.           is  specified,  telnet will attempt to contact a TELNET
  60.           server at the default port.  The host specification may
  61.           be either a host name or an Internet address  specified
  62.       in the "dot notation".
  63.  
  64.      close
  65.           Close a TELNET session and return to command mode.
  66.  
  67.      quit Close any open TELNET session and exit telnet.  An  EOF
  68.           (in command mode) will also close a session and exit.
  69.  
  70.      mode type
  71.           type is either line (for "line by line" mode) or  char-
  72.           acter  (for  "character  at  a time" mode).  The remote
  73.           host is asked for permission to go into  the  requested
  74.           mode.   If  the remote host is capable of entering that
  75.           mode, the requested mode will be entered.
  76.  
  77.      status
  78.           Show the current status of telnet.  This  includes  the
  79.           peer one is connected to, as well as the current mode.
  80.  
  81.      display [ argument... ]
  82.           Display all, or some, of the set and toggle values (see
  83.           below).
  84.  
  85.      ? [ command ]
  86.           Get help.  With no arguments, telnet prints a help sum-
  87.           mary.  If a command is specified, telnet will print the
  88.           help information for just that command.
  89.  
  90.      ^d
  91.           Send control-d to the host.
  92.  
  93.      send arguments
  94.           Send one or more special  character  sequences  to  the
  95.           remote host.  The following are the arguments which may
  96.           be specified (more than one argument may  be  specified
  97.           at a time):
  98.  
  99.           escape
  100.                Send the current  telnet  escape  character  (ini-
  101.                tially `^]').
  102.  
  103.           synch
  104.                Send the TELNET  SYNCH  sequence.   This  sequence
  105.                causes the remote system to discard all previously
  106.                typed (but not yet read) input.  This sequence  is
  107.                sent  as  TCP urgent data (and may not work if the
  108.                remote system is a 4.2 BSD system --  if  it  does
  109.                not  work,  a  lower case "r" may be echoed on the
  110.                terminal).
  111.  
  112.           brk  Send the TELNET BRK (Break)  sequence,  which  may
  113.                have significance to the remote system.
  114.  
  115.           ip   Send the TELNET IP (Interrupt  Process)  sequence,
  116.                which  should cause the remote system to abort the
  117.                currently running process.
  118.  
  119.           ao   Sends the TELNET AO (Abort Output) sequence, which
  120.                should cause the remote system to flush all output
  121.                from the remote system to the user's terminal.
  122.  
  123.           ayt  Sends the TELNET AYT (Are You There) sequence,  to
  124.                which  the  remote system may or may not choose to
  125.                respond.
  126.  
  127.           ec   Sends the TELNET EC  (Erase  Character)  sequence,
  128.                which  should cause the remote system to erase the
  129.                last character entered.
  130.  
  131.           el   Sends the TELNET EL (Erase Line)  sequence,  which
  132.                should  cause  the remote system to erase the line
  133.                currently being entered.
  134.  
  135.           ga   Sends the TELNET GA  (Go  Ahead)  sequence,  which
  136.                likely has no significance to the remote system.
  137.  
  138.           nop  Sends the TELNET NOP (No Operation) sequence.
  139.  
  140.           ?    Prints out help information for the send command.
  141.  
  142.      set argument value
  143.           Set any one of  a  number  of  telnet  variables  to  a
  144.           specific  value.  The special value "off" turns off the
  145.           function associated with the variable.  The  values  of
  146.           variables may be interrogated with the display command.
  147.           The variables which may be specified are:
  148.  
  149.           echo This is the value (initially `^E') which, when  in
  150.                "line  by  line" mode, toggles between doing local
  151.                echoing of entered characters (for normal process-
  152.                ing),  and  suppressing echoing of entered charac-
  153.                ters (for entering, say, a password).
  154.  
  155.           escape
  156.                This is the  telnet  escape  character  (initially
  157.                `^[')  which causes entry into telnet command mode
  158.                (when connected to a remote system).
  159.  
  160.           interrupt
  161.                If telnet is in localchars mode (see toggle local-
  162.                chars below) and the interrupt character is typed,
  163.                a TELNET IP sequence (see send ip above)  is  sent
  164.                to  the  remote  host.   The initial value for the
  165.                interrupt character is taken to be the  terminal's
  166.                intr character.
  167.  
  168.           quit If telnet is in localchars mode (see toggle local-
  169.                chars  below)  and  the quit character is typed, a
  170.                TELNET BRK sequence (see send brk above)  is  sent
  171.                to  the  remote  host.   The initial value for the
  172.                quit character is taken to be the terminal's  quit
  173.                character.
  174.  
  175.           flushoutput
  176.                If telnet is in localchars mode (see toggle local-
  177.                chars  below)  and  the  flushoutput  character is
  178.                typed, a TELNET AO sequence (see send ao above) is
  179.                sent  to  the  remote host.  The initial value for
  180.                the flush character is taken to be the  terminal's
  181.                flush character.
  182.  
  183.           erase
  184.                If telnet is in localchars mode (see toggle local-
  185.                chars below), and if telnet is operating in "char-
  186.                acter at a time" mode, then when this character is
  187.                typed, a TELNET EC sequence (see send ec above) is
  188.                sent to the remote system.  The initial value  for
  189.                the  erase character is taken to be the terminal's
  190.                erase character.
  191.  
  192.           kill If telnet is in localchars mode (see toggle local-
  193.                chars below), and if telnet is operating in "char-
  194.                acter at a time" mode, then when this character is
  195.                typed, a TELNET EL sequence (see send el above) is
  196.                sent to the remote system.  The initial value  for
  197.                the  kill  character is taken to be the terminal's
  198.                kill character.
  199.  
  200.           eof  If telnet is operating in  "line  by  line"  mode,
  201.                entering  this character as the first character on
  202.                a line will cause this character to be sent to the
  203.                remote system.  The initial value of the eof char-
  204.                acter is taken to be the terminal's eof character.
  205.  
  206.      toggle arguments...
  207.           Toggle (between TRUE and FALSE) various flags that con-
  208.           trol  how  telnet  responds  to  events.  More than one
  209.           argument may be specified.  The state  of  these  flags
  210.           may  be  interrogated  with the display command.  Valid
  211.           arguments are:
  212.  
  213.           localchars
  214.                If this is TRUE, then the flush, interrupt,  quit,
  215.                erase,  and  kill  characters  (see set above) are
  216.                recognized locally, and  transformed  into  (hope-
  217.                fully)   appropriate   TELNET   control  sequences
  218.                (respectively ao, ip, brk, ec, and  el;  see  send
  219.                above).  The initial value for this toggle is TRUE
  220.                in "line by line" mode, and FALSE in "character at
  221.                a time" mode.
  222.  
  223.           autoflush
  224.                If autoflush and localchars are  both  TRUE,  then
  225.                when  the  ao, intr, or quit characters are recog-
  226.                nized (and transformed into TELNET sequences;  see
  227.                set  above for details), telnet refuses to display
  228.                any data on the user's terminal until  the  remote
  229.                system  acknowledges  (via  a  TELNET  Timing Mark
  230.                option)  that  it  has  processed   those   TELNET
  231.                sequences.   The  initial value for this toggle is
  232.                TRUE if the terminal user had not  done  an  "stty
  233.                noflsh", otherwise FALSE (see stty(1V)).
  234.  
  235.           autosynch
  236.                If autosynch and localchars are  both  TRUE,  then
  237.                when  either  the intr or quit characters is typed
  238.                (see set above for descriptions of  the  intr  and
  239.                quit  characters),  the  resulting TELNET sequence
  240.                sent is followed by  the  TELNET  SYNCH  sequence.
  241.                This  procedure  should cause the remote system to
  242.                begin throwing away  all  previously  typed  input
  243.                until  both of the TELNET sequences have been read
  244.                and acted upon.  The initial value of this  toggle
  245.                is FALSE.
  246.  
  247.           crmod
  248.                Toggle RETURN mode.  When this  mode  is  enabled,
  249.                most  RETURN  characters  received from the remote
  250.                host will be mapped into a RETURN  followed  by  a
  251.                LINEFEED.  This mode does not affect those charac-
  252.                ters typed by the user, only those  received  from
  253.                the  remote  host.   This  mode is not very useful
  254.                unless the remote  host  only  sends  RETURN,  but
  255.                never  LINEFEED. The initial value for this toggle
  256.                is FALSE.
  257.  
  258.           debug
  259.                Toggle socket level debugging (useful only to  the
  260.                super-user).  The initial value for this toggle is
  261.                FALSE.
  262.  
  263.           options
  264.                Toggle the display of some internal telnet  proto-
  265.                col processing (having to do with TELNET options).
  266.                The initial value for this toggle is FALSE.
  267.  
  268.           netdata
  269.                Toggle the display of all network data (in hexade-
  270.                cimal  format).  The initial value for this toggle
  271.                is FALSE.
  272.  
  273.           ?    Display the legal toggle commands.
  274.  
  275. BUGS
  276.      There is no adequate way for dealing with flow control.
  277.  
  278.      On some remote systems, echo has to be turned  off  manually
  279.      when in "line by line" mode.
  280.  
  281.      There is enough settable state to justify a .telnetrc file.
  282.  
  283.      No capability for a .telnetrc file is provided.
  284.  
  285.      In "line by line" mode, the terminal's EOF character is only
  286.      recognized  (and  sent  to the remote system) when it is the
  287.      first character on a line.
  288.  
  289.